home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / pdr.z / pdr
Encoding:
Text File  |  1998-10-20  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppddddrrrr((((3333GGGG))))                                                                ppppddddrrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppddddrrrr,,,, ppppddddrrrriiii,,,, ppppddddrrrrssss,,,, ppppddddrrrr2222,,,, ppppddddrrrr2222iiii,,,, ppppddddrrrr2222ssss - specifies the next point of a
  10.      polygon
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppddddrrrr((((xxxx,,,, yyyy,,,, zzzz))))
  14.      rrrreeeeaaaallll xxxx,,,, yyyy,,,, zzzz
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppddddrrrriiii((((xxxx,,,, yyyy,,,, zzzz))))
  17.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxx,,,, yyyy,,,, zzzz
  18.  
  19.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppddddrrrrssss((((xxxx,,,, yyyy,,,, zzzz))))
  20.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx,,,, yyyy,,,, zzzz
  21.  
  22.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppddddrrrr2222((((xxxx,,,, yyyy))))
  23.      rrrreeeeaaaallll xxxx,,,, yyyy
  24.  
  25.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppddddrrrr2222iiii((((xxxx,,,, yyyy))))
  26.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxx,,,, yyyy
  27.  
  28.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppddddrrrr2222ssss((((xxxx,,,, yyyy))))
  29.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx,,,, yyyy
  30.  
  31.      All of the above routines are functionally the same.  They differ only in
  32.      the type declarations of their parameters and in whether they expect a
  33.      two- or three-dimensional space.
  34.  
  35. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  36.      _x   expects the _x coordinate of the next defining point for the polygon.
  37.  
  38.      _y   expects the _y coordinate of the next defining point for the polygon.
  39.  
  40.      _z   expects the _z coordinate of the next defining point for the polygon.
  41.  
  42. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  43.      ppppddddrrrr specifies the next point of a polygon.  When ppppddddrrrr is executed, it
  44.      draws a line to the specified point (_x,_y,_z) which then becomes the
  45.      current graphics position.  The next ppppddddrrrr call will start drawing from
  46.      that point.  To draw a typical polygon start with ppppmmmmvvvv, follow it with a
  47.      sequence of calls to ppppddddrrrr and end it with ppppcccclllloooossss.
  48.  
  49. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  50.      The following sequence draws a square:
  51.  
  52.           call pmv(0.0, 0.0, 0.0)
  53.           call pdr(1.0, 0.0, 0.0)
  54.           call pdr(1.0, 1.0, 0.0)
  55.           call pdr(0.0, 1.0, 0.0)
  56.           call pclos
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppddddrrrr((((3333GGGG))))                                                                ppppddddrrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      bgnpol, endpol, pclos, pmv, v
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      ppppddddrrrr should not be used in new development.  Rather, polygons should be
  79.      drawn using the high-performance vvvv commands, surrounded by calls to
  80.      bbbbggggnnnnppppoooollll and eeeennnnddddppppoooollll.
  81.  
  82.      There can be no more than 256 vertices in a polygon.  Therefore, there
  83.      can be no more than 255 ppppddddrrrr calls between ppppmmmmvvvv and ppppcccclllloooossss.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.